home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
BBS Toolkit
/
BBS Toolkit.iso
/
doors_2
/
rombrain.zip
/
ROMBRAIN.DOC
< prev
next >
Wrap
Text File
|
1991-12-13
|
14KB
|
348 lines
December 13, 1991
1.
ROMBRAIN
(C) Copyright 1991 by Stanley Sheff
Support BBS: The Brainex System
(310) 275-2344
(310) 273-5234
A CDROM File Door for any BBS using any CD.
-------------------------------------------
Welcome to the RomBrain. Now your callers can access your CDROM drive
without having to use your BBS's file system. This door works with
GAP, PCBoard, Wildcat, Spitfire, WWIV, and RBBS, as well as any BBS that
generates a DOOR.SYS file when running a door. RomBrain is a multi-user
door and requires SHARE.EXE and DOS 3.3 or above. RomBrain WILL NOT WORK
on versions of GAP below 5. RomBrain will NOT check download limits on
nonGAP BBSes.
RomBrain requires the program DSZ.COM or DSZ.EXE in the path.
If you have an unregistered DSZ, Y-Modem G protocol will NOT function.
Some older DOOR.SYS conversion programs may generate an ERROR 62.
You will need to use a newer version of DOOR.SYS if this problem
occurs...
Here's what the RomBrain can do:
Supports IBM ANSI Color and plain text mode (ASCII)
for your callers who don't use IBM characters or don't use ANSI.
RomBrain supports com ports opened up to 38400 and as
many of them as you can fit in the machine. This makes RomBrain easy
to set up on a multi-node system with GAP. RomBrain will also
support several other BBSes by the use of conversion programs available
nearly everywhere.
RomBrain creates an index file from information stored on your CD.
The file uses about 600K of disk space.
Menu Functions:
[F]ile Directory
Allows you to select one of the CD ROM directories. Once you've
selected a directory, you may:
[D]ownload file(s)
You can add names to a list of files for download. The list
may be edited. If you use Xmodem Protocol, each file will
be sent one at a time, and you will be asked if you wish to
continue receiving files from the list.
[M]ark a file
Add the file name entered to a list to be downloaded later.
Just type the letter shown to the left of the filename.
2.
[A]rchive
View contents of a .ZIP file, Read a file from within the .ZIP file,
Transfer (Download) a file from within the .ZIP file, or Download
the entire .ZIP file.
[S]earch for text within the directory. You may enter all or any
part of a word for a search. This function searches filename, date,
and description. Selected word will be highlighted in red for color
or <brackets> for monochrome.
The above commands are available from the Main Menu as well as the
Directory Menu.
*NOTE: When asked to enter a file name, .ZIP will be added automatically
if you do not include an extender.
RomBrain Files
----------------
ROMBRAIN.EXE <------------------ RomBrain Program
ROMBRAIN.DOC <------------------ Sysop's Information
CDBRAIN.CNF <------------------ Sample Configuration File
REGISTER.DOC <------------------ Registration information
SETUP.EXE <------------------ Setup / Initializer Program
HELP <------------------ General Help File
CDHELP <------------------ Download Help File
WELCOME <------------------ ASCII Welcome Screen
WELCOMEG <------------------ ANSI Welcome Screen
DOOR.SYS <------------------ Sample DOOR.SYS file
EXTSX.BAT <------------------ Batch File to call DSZ Xmodem
EXTS1.BAT <------------------ Batch File to call DSZ Xmodem/1K
EXTSY.BAT <------------------ Batch File to call DSZ Ymodem
EXTSZ.BAT <------------------ Batch File to call DSZ Zmodem
EXTSF.BAT <------------------ Batch File to call DSZ Xmodem/1K-G
EXTSG.BAT <------------------ Batch File to call DSZ Ymodem-G
All of these files should be in this ZIP, if they are not, don't
take a chance! Call The Brainex System and get a good copy or view the
file on a few local boards to see if you can find a complete copy.
The setup of RomBrain is simple, all you need to do is create a
directory for RomBrain and its files then copy the files into that
directory. After that you will need to create a config file with
the following information and place it in that directory.
3.
(sample CDBRAIN.CNF)
C:\GAP
The Brainex System
GAP
0000000
E:
50
C:\CDROM
A
X1YZFG
Sorry! Downloads Restricted to Level 50
===================================================================
(You do not need to remove these comments, RomBrain reads only the
first 9 lines of this file...)
===================================================================
Line 1 Path to DOOR.SYS, DORINFO1.DEF, CHAIN.TXT, or SFDOORS.DAT
Line 2 BBS Name
Line 3 BBS Type: GAP (DOOR.SYS/GAP ONLY!) SF (Spitfire/SFDOORS.DAT)
WC3 (Wildcat 3/DOOR.SYS) WWIV (CHAIN.TXT)
PCB (PCBOARD 14/DOOR.SYS) RBBS (DORINFO1.DEF)
GEN (Generic DOOR.SYS/All Other BBSes)
Line 4 Registration Number
Line 5 CD ROM Drive Device ID
Line 6 Access Level for Downloads
Line 7 Path to CDTYPE_x.x and CD_DATA Files
Line 8 CD Type A=CARRS B=GRAB BAG C=RBBS IN-A-BOX D=CUSTOM
Line 9 Transfer Protocols:
X=Xmodem
1=Xmodem/1K
Y=Ymodem Batch
Z=Zmodem
J=Jmodem
G=Ymodem-G (MNP)
F=Xmodem/1K-G (MNP)
Line 10 Restricted Downloads Message
============================================================================
Note: If using GAP and you do not want to update user stats,
Just set line 8 to PCB, and RomBrain will NOT write
any data to the users.dat file or caller logs.
RomBrain will NOT check for download file limits on non GAP BBSes.
Indicate on line 9 the types of file transfer protocols you
can support.
RomBrain handles all of its file transfers from within the door.
The sysop may define which protocols to use. A set of predefined
protocol batch files are included for use with the DSZ protocol engine.
4.
Parameters are passed to the protocol batch files in the following order:
%1 - Communications port
%2 - Baud rate
%3 - File name to send
SETUP
=====
Use SETUP.EXE to initialize RomBrain. SETUP.EXE requires the sample
DOOR.SYS to be placed in the same directory as SETUP.EXE.
Before you use SETUP, it's a good idea to know the contents of
your CD. Make a note of the location of the text files that
describe the directories of your CD, and their names.
For most CDs, use the AUTOMATIC SETUP option. If you like, you may
edit the file CDTYPE_x.4 to customize category names. The "x" will
be substituted for CD type. Ex. CDTYPE_A.4 is for type A, CARRS CD.
For Multi-Node systems, SETUP will create a WORK directory for each
node (WORK1, WORK2, etc.)
The setup program will create the following files:
CDTYPE_x.1
CDTYPE_x.2
CDTYPE_x.3
CDTYPE_x.4 (ASCII file of category names. Edit this for accuracy!)
The file directory menu is generated internally by the RomBrain,
but if you wish to use a customized menu, just create your menu
and name it MENUx for ASCII and MENUxG for ANSI. "x" stands for
the CD Type (MENUA=CARRS, etc.). Place the MENUx files in
the same directory as RomBrain.
If you use more than one CD drive, you can use the SETUP to create
a set of data files for each. Example:
CARRS CD would have these files:
CDTYPE_A.1 CDTYPE_A.2 CDTYPE_A.3 CDTYPE_A.4
RBBS IN A BOX would have these:
CDTYPE_C.1 CDTYPE_C.2 CDTYPE_C.3 CDTYPE_C.4
5.
Make a directory for each set of cdtype files, then copy the files into
the directory.
Edit the sample DRIVE.DAT file to match your set up. The format for this
file is: CD VOLUME NAME,CDTYPE CODE,CD DRIVE LETTER,PATH TO CDTYPE FILES
There should be a line of information for each CD.
Example DRIVE.DAT file:
CARRS #4,A,D:,C:\CDROM\CARRS4
CARRS #5,A,E:,C:\CDROM\CARRS5
RBBS IN A BOX,C,F:,C:\CDROM\RBBS
Note: Use the comma to separate the information. If you use a comma
within the information like: CARRS, #4 errors will occur.
Include a colon with drive letter (Example E:).
Once you have created your config file, you must then create a a batch
file to call the door. A batch file for a GAP BBS might look like this:
ECHO OFF
SET DSZLOG=LOGx <-------(Required for DSZ x=Node Number)
CD \DOORS\ROMBRAIN
ROMBRAIN CDBRAIN.CNF
CD \GAP
It is recommended but not required that you call RomBrain with the
config file's name on the command line. If you don't, RomBrain will
simply default to CDBRAIN.CNF.
You will also need to modify your doors menu files and the data
file that tells the BBS what your doors are and the security
level needed to access them. For GAP, these are respectively:
DOORM
DOORMG
DOORS.DAT
Please refer to your BBS documentation for details on
setting up these files.
If you are running multi-nodes, simply create a separate door
configuration file for each node, and number them. For instance,
for a 3 node system, you might have the following configuration
files:
CDBRAIN1.CNF
CDBRAIN2.CNF
CDBRAIN3.CNF
6.
The only difference between the three would be the 1st line which
points to the default directory for the particular node.
Another easy way to add the RomBrain to GAP is to use Gap's
configuration option to create a SYSOP DEFINED COMMAND (consult Gap's
docs for info on sysop defined commands). On The Brainex System I use
CDROM. The batch file to run RomBrain is named CDROM.BAT and placed
in the BBS default directory (C:\GAP). When a caller types CDROM at the
main prompt, they are instantly taken to the RomBrain.
The following files are read during door initialization. They
must be present or the door will not operate.
DOOR.SYS (or DORINFO1.DEF, CHAIN.TXT, SFDOORS.DAT)
GAPBBS.CNF (GAP BBS only)
USERS (GAP BBS only)
The following sysop functions are available while awaiting
keyboard input :
F5 - Shell to DOS.
F8 - Twit user and return to BBS.
F10 - Initiate chat with user.
CF10 - Answer user page bell.
Home - Main user stats.
End - Displays sysop keys available.
PgDn - Secondary user stats.
Up Arrow - Increase user's time remaining by 5 minutes.
Dn Arrow - Decrease user's time remaining by 5 minutes.
One of the nicer features about using the TWIT key, is the user
is not told that "the sysop wants them to return to the BBS".
Instead, a very plain and simple message of "returning you to the
BBS" is displayed. This way, the user is given no indication
that the sysop is hovering about.
When using the F5 shell to DOS key, to return to the door
program, simply type EXIT at the DOS command prompt. It is not
necessary to change directories back to the door directory.
RomBrain is smart enough to know which drive and directory the
door program is in and will reset the defaults upon return from
DOS.
The Up and Down Arrow keys increase and decrease the user's time
respectively by 5 minutes for each press of the key. There is no
indication of what is occurring (except by the fact the user's
time remaining will change), so the sysop should try not to have
a lead finger. The increase or decrease is effective only while
the user is in RomBrain.
7.
This version of RomBrain is a DEMO. It will become full featured
upon registration. This door is released "As Is" and
there is *NO* warranty or guarantee that it will work for you and
not cause any problems. You have chosen to use this door, YOU are
responsible for any unfortunate problems that may develop from its
use or misuse. I will gladly listen to any suggestions or
problems you may have, and I will do my best to fix whatever
needs to be fixed. I can not be held responsible for any problems
you may have, whether directly or indirectly due to the use of the
door or its utilities or associated files.
Please read REGISTER.DOC for information on how you can register
your copy of RomBrain. The download option will only work on
a registered version.
For complete support, contact PROFESSOR BRAINEX on The Brainex System.
Your questions will be quickly and cheerfully answered!
Have Fun!
Stanley Sheff
The Brainex System
310-275-2344 HST
310-273-5234 MNP